package com.youlai.boot.modules.game.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.youlai.boot.modules.game.model.entity.GameInfo;
import com.youlai.boot.modules.game.model.query.GameInfoQuery;
import com.youlai.boot.modules.game.model.vo.GameInfoVO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 游戏信息Mapper接口
 *
 * @author 有来技术团队
 */
@Mapper
public interface GameInfoMapper extends BaseMapper<GameInfo> {

    /**
     * 获取游戏分页列表
     *
     * @param page 分页对象
     * @param query 查询参数
     * @return 游戏分页列表
     */
    Page<GameInfoVO> getGamePage(Page<GameInfo> page, @Param("query") GameInfoQuery query);

    /**
     * 根据ID获取游戏详情
     *
     * @param id 游戏ID
     * @return 游戏详情
     */
    GameInfoVO getGameById(@Param("id") Long id);

    /**
     * 获取推荐游戏列表
     *
     * @param limit 限制数量
     * @return 推荐游戏列表
     */
    List<GameInfoVO> getFeaturedGames(@Param("limit") Integer limit);

    /**
     * 获取热门游戏列表
     *
     * @param limit 限制数量
     * @return 热门游戏列表
     */
    List<GameInfoVO> getHotGames(@Param("limit") Integer limit);

    /**
     * 获取新品游戏列表
     *
     * @param limit 限制数量
     * @return 新品游戏列表
     */
    List<GameInfoVO> getNewGames(@Param("limit") Integer limit);

    /**
     * 根据分类获取游戏列表
     *
     * @param categoryId 分类ID
     * @param limit 限制数量
     * @return 游戏列表
     */
    List<GameInfoVO> getGamesByCategory(@Param("categoryId") Long categoryId, @Param("limit") Integer limit);

    /**
     * 增加游戏下载次数
     *
     * @param id 游戏ID
     * @return 影响行数
     */
    int incrementDownloadCount(@Param("id") Long id);

    /**
     * 更新游戏评分
     *
     * @param id 游戏ID
     * @param rating 评分
     * @return 影响行数
     */
    int updateRating(@Param("id") Long id, @Param("rating") Double rating);
} 